Aminet 35/Aminet 35 (2000)(Schatztruhe)[!][Feb 2000].iso/Aminet/comm/irc/CTCPMaster.lha/CTCP-Master.readme

Text File | 1999-12-13 | 5.4 KB | 161 lines

                                CTCP-Master v1.12
                       by Roger Clark ([e-mail])


What is it?

CTCP-Master  is  an  ARexx  add-on  script  for  AmIRC  2.x  and above that adds
functions  found  on  most popular Bots.  This script originated from the source
code of AmIRCOS a few years ago, and has grown and added many new features since
then.  The script itself is uncompressed ARexx, so you can modify it if you want
without  needing  to  "decrunch"  it.   All  I  ask  is  that  you  send  me any
modifications that you make if you add new features to the script.

What does it do?

This  is the list of currently supported functions in CTCP-Master.  In order for
you to use any of these commands locally, you must send yourself a /MSG with the
command.   AmIRC  doesn't  return  your  text  to the ARexx port the same way it
handles it from remote users.

  Host Functions: Only usable by your nick.

    #AWAY
      Displays an AWAY message and monitors /CTCP Page requests.

    #FAQADD
      Adds a FAQ to the main FAQ listing.

    #FAQKILL
      Removes a FAQ from the main FAQ listing.

    #FAQREAD
      Re-reads the main FAQ listing if you edited it manually.

    #OPS
      Add or Remove hostmasks from the Auto-OP list.

    #QUIT
      Displays a random QUIT message from the CTCP-QuitMsgs file.

    #SHOWOPS
      Shows all hostmasks being monitored for Auto-OP privledge.

    #SOUND
      Opens a requestor to allow you to send a /CTCP Sound request to a user or
      channel.

    #STOP
      Signals CTCP-Master to exit.

  Remote User Functions:

    /CTCP Commands:

      PING
        Sends a random reply to PING requests.

      SOUND
        Handles SOUND requests, including auto-requesting files that are not on
        your computer.

      USERINFO
        Displays an enhanced USERINFO message.

  Trigger Commands:

    The  trigger  is  user-defineable  in the CTCP-Master.cfg file.  The default
    trigger is the exclamation point.

      !CALC
        Performs basic math functions and returns the result.
        Note: Currently no error checking is done to be sure the argument
              is a valid mathematical function.

      !CONVERT
        Converts between various units of measurements.

      !COUNTRY (or !WHERE)
        Displays ISO <--> Normal country code translations.
        Example: GB is the ISO country code for Great Britain.

      !DNS
        Performs a DNS lookup on the given hostname or IP address.
        Using the -s switch, you can look up Port/Service information as well.

      !EXCHANGE (or !CURRENCY)
        Displays current international currency exchange rates as reported
        by http://www.xe.net/ucc

      !FAQ
        Lists the name and decription of a selected FAQ, or lists available FAQs
        if none is specified.

      !FAQADD
        Lets remote users add FAQ topics to the main FAQ listing.

      !FIND
        Searches Aminet for the specified text.

      !FORECAST
        Will display the current weather conditions for the given city or US Zip Code,
        along with an 3 to 5 day extended forecast sent via private Notice to the user.
        Most International cities are supported.  This function will query the
        database at http://www.wunderground.com for weather information.

      !HOROSCOPE
        Displays a horoscope for the requested star sign.

      !LAST
        Returns the last known /QUIT message for the selected user.

      !MONTH
        Sends an ASCII calendar to the remote user.

      !PAGE
        Will execute a remote command when you are paged. Additional arguments
        can be passed now to an external program. Env variable $Pager is now set
        with the name and reason for the page.  Use \$Pager\ to pass this as an
        argument to an external program.

      !SEEN
        Lists when a user was last seen on the current channel, or any channel
        you may be joined to at the time of the request.

      !SHOWCOMMANDS
        Displays a listing of all avaiable commands supported by CTCP-Master.

      !STOCK
        Will display the last reported value and change for the given stock symbol.

      !TEMP
        Will display the current temperature for the given city or US Zip Code.
        Most International sities are supported.  This function will query the
        database at http://www.wunderground.com for weather information.

      !TIME
        Displays current time as GMT.

      !TRANSLATE
        Allows you to get translations of text.  Supports English to/from
        Spanish, French, German, Protuguese, Italian.

      !WEATHER
        Will display the current weather conditions for the given city or US Zip Code.
        Most International cities are supported.  This function will query the
        database at http://www.wunderground.com for weather information.

      !ZIP
        Will display the corresponding US city for the supplied ZIP Code.

Installing the script:

Simply   unarc   the   files  into  the  AmIRC:Rexx/  directory,  and  edit  the
CTCP-Master.cfg  file  to show your personal information.  You can also edit the
CTCP-Master.pings  file if you wish to add/change/delete any of the default ping
responses.

Optionally,  you  can  rename  CTCP-Master.amirx  to Connected.amirx and it will
start as soon as you connect to a Server.